Unflattens a collection that was flattened using the FlattenCollectionToHdl utility function.

OSErr UnflattenCollectionFromHdl (
    Collection aCollection, 
    Handle flattened
);

aCollection

A reference to a collection object in which to store the unflattened information. The behavior of this function is undefined if you do not provide a reference to a valid collection object.

flattened

A handle to the data that was previously flattened. You must provide a valid Macintosh Memory Manager handle in this parameter.

function result

A result code.

DISCUSSION

To unflatten a collection directly from disk, use the UnflattenCollection function.

To flatten a collection to a block of memory referenced by a handle, use the FlattenCollectionToHdl function.

AVAILABILITY

Supported in Carbon. Available in Mac OS 8.1 and later when Carbon 1.0.2 or later is present.

© 2000 Apple Computer, Inc. — (Last Updated 5/8/2000)